Module i2p.samclasses
Lower-level SAM API, interfaces with SAM Bridge.
For internal use only.
Use the higher level i2p.socket module for your own programs.
For details on SAM, see "Simple Anonymous Messaging (SAM)
v1.0," as published by jrandom.
Class Overview:
-
SAMTerminal: Message sender/reader, talks to SAM Bridge.
-
StringBuffer: Queue for character data.
-
BaseSession: SAM session classes are derived from this.
-
StreamSession: SAM stream session class, threadsafe, high
level.
-
DatagramSession: SAM datagram session, threadsafe, high level.
-
RawSession: SAM raw session, threadsafe, high level.
Note that a 'None' timeout is an infinite timeout: it blocks forever
if necessary.
Todo:
-
Error handling is a huge mess. Neaten it up. Subclass a ErrorMixin
class, then use set_error(e), check_error(), get_error().
-
Streams are a huge mess. Neaten them up.
-
This whole interface is a tad confusing. Neaten it up.